home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 9 / The PC-SIG Library on CD ROM - Ninth Edition.iso / 801_900 / DISK0893 / DISK0893.ZIP / WEAKLINK.DOC < prev   
Text File  |  1988-07-29  |  18KB  |  436 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                              The WEAK Link
  18.  
  19.  
  20.                                Version 1.1a
  21.                            (Shareware version)
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                          (c) Copyright 1987-1988
  28.  
  29.                              Don Jindra
  30.                              Information Modes
  31.                              P.O. Drawer F.
  32.                              Denton, Texas  76202 
  33.                              Phone 817-387-3339
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.         This product may be distributed freely as long as nothing is added 
  59. to, altered, or removed from the disk.  This is a shareware version of a 
  60. commercial product.  It is fully functional but does not include source code.
  61. A registered copy of this product can be purchased from Information Modes.
  62.  
  63. ;page
  64.                                                                         PAGE 1 
  65.                                INTRODUCTION
  66.  
  67.  
  68.         This is a simple master/slave serial link-up program.  Two standard 
  69. IBMs or clones can be linked together via RS232 ports and a null modem cable.  
  70. COM1 thru COM4 may be used.  The master program is a device driver which must 
  71. be included in the config.sys file.  It is always resident and always "on".  
  72. The slave is a .com program which, when run, allows the master to use any block 
  73. device installed on that slave.   For instance, if the master has 1 floppy as 
  74. A: and 1 hard disk as drive C:, then  drive D: can be the slave's drive A:, and 
  75. drive E: can be the slave's drive C:, and drive F: can be the slave's RAMDRIVE.
  76. Mapping of the slave's drives to the master can be in any order and can include 
  77. or exclude any of the slave's block devices. Mapping is done via a 
  78. SHARE:abcd...  parameter on the slave program's command line.  When the slave 
  79. program is running the master has complete control of the computer.  This 
  80. utility is primarily intended to allow file transfers between two machines with 
  81. different or non-removable media.  You could transfer from a portable's 3 1/2 
  82. inch drives to a 5 1/4 inch drive on another machine. Or you could transfer an 
  83. entire directory of one hard disk to another on a different machine.  Transfer 
  84. speed is selectable from 1200 to 115k baud.  Transfer is extremely simple since 
  85. the master thinks the slave is a collection of drives.  Standard COPY and DIR 
  86. commands work equally well on the master or slave drives.  
  87.  
  88.  
  89.  
  90. NOTE: Some later model PCs use 82C50 UARTs which have a bug.  NEC Multispeed
  91.       is one example.  This bug causes The WEAK Link to run sporadically.
  92.       A fix is in the works.
  93.  
  94.  
  95. ;page
  96.                                                                         PAGE 2
  97.  
  98.  
  99.                                INSTALLATION
  100.  
  101.  
  102.  
  103.         The WEAK Link will work on any IBM PC/XT/AT which has a serial card 
  104. installed.  The card must follow the IBM specifications as outlined in the 
  105. Technical Reference manual.  If it uses a 8250 or 16450 communications chip 
  106. then it is probably ok.  The memory requirements are minimal.  DOS 2.0 or 
  107. higher is required.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114. SIMPLIFIED STEPS:
  115.  
  116.  
  117.        COPY CONFIG.S                  to the slave's boot disk.
  118.        REN  CONFIG.S  CONFIG.SYS      on the slave's boot disk.
  119.        COPY NET00000.SYS              to the slave's boot disk.
  120.        COPY PS.COM                    to the slave's boot disk.
  121.                                       reboot the slave computer
  122.  
  123.        COPY CONFIG.M                  to the master's boot disk
  124.        REN  CONFIG.M  CONFIG.SYS      on the master's boot disk
  125.        COPY PM.SYS                    to the master's boot disk.
  126.                                       reboot the master computer
  127.  
  128.        run PS.COM                     on the slave
  129.  
  130.  
  131.  
  132.        The master can now use the slave's drives as it's own.  These 
  133. directions assume both systems have at least one 5 1/4 inch drive to read 
  134. this disk.
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141. TRANSFERING TO OTHER MEDIA:
  142.  
  143.  
  144.         Included on this disk are two short BASICA programs which can be used 
  145. to transfer the slave's startup files via a serial link. TMT.BAS should be run 
  146. on the machine which can read this disk.  RCV.BAS should be run on the other 
  147. machine, and will have to be typed in at the keyboard.  The program is short 
  148. and shouldn't take much time to enter.  Once RCV.BAS has been entered on the 
  149. other machine, run it under BASICA or GWBASIC.  Make sure your null cable is 
  150. hooked up.  Then run TMT.BAS under BASICA on the main machine.  TMT.BAS will 
  151. transfer (slowly) the three files you will need to set up the other machine as 
  152. a slave.  Then you can transfer the rest of this disk mush faster using The 
  153. WEAK Link.  
  154.  
  155.         If all else fails, other media can be supplied.
  156.  
  157.  
  158. ;page
  159.                                                                         PAGE 3
  160.  
  161.  
  162.  
  163. SLAVE INSTALLATION:
  164.  
  165.         The config.sys file must include the line:
  166.  
  167.                 device=net0.sys
  168.  
  169.         The net0.sys character device is used to setup the internal device 
  170. driver list.  If net0.sys is not properly installed the slave program cannot 
  171. find the addresses of the DOS device drivers.  It should be the first device 
  172. in the list so should be the last line in the config.sys file.  
  173. Programmers.... any 4 byte read of net0 will return the dword pointer to the 
  174. net0 device driver.  This dword address can be used to search through the DOS 
  175. device driver chain.  
  176.  
  177.         Once net0.sys is installed,  you can run ps.com to put the computer 
  178. into the slave mode.  If the communication port you are using is not COM1 
  179. then you must indicate which port you are using with the COMx parameter on 
  180. the command line.  If the baud rate you want is not 56k baud then you must 
  181. indicate your baud rate on the command line with the /nn parameter.  You can 
  182. modify the order slave drives are presented to the master by using the 
  183. SHARE:xxx parameter.  These parameters are described below.  When the 
  184. master/slave link is no longer needed, just press "q" and the slave will 
  185. return to normal operation.  
  186.  
  187.         EXAMPLE:
  188.  
  189.         A> PS COM1 /2 SHARE:ACDE
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. MASTER INSTALLATION:
  197.  
  198.  
  199.         The config.sys file must include the line:
  200.  
  201.                 device=pm.sys
  202.  
  203.         When the system reboots, the master is installed and will display its 
  204. sign-on message.  Then the master can access the slave whenever the slave is 
  205. running ps.com.  Necessary parameters are entered on the config.sys command 
  206. line.  Parameters are just as in the slave device with the addition of an @nn 
  207. parameter which tells DOS how many devices the slave will support.  
  208.  
  209.                 EXAMPLE:
  210.  
  211.                 DEVICE=PM.SYS COM2 /2 @4
  212.  
  213.  
  214.  
  215. COMBINATION MASTER/SLAVE:
  216.  
  217.         You can combine the master and slave configuration files.  This will
  218. allow you to run the slave program PS.COM on either machine then access that 
  219. machine from the other.  Both machines would have the master installed:
  220.  
  221.                DEVICE=NET00000.SYS
  222.                DEVICE=PM.SYS
  223. ;page
  224.                                                                         PAGE 4
  225.  
  226.  
  227.                                 COMMAND LINE PARAMETERS
  228.  
  229.  
  230.  
  231. COMx            You can use COM1 thru COM4 as the communications port on
  232.                 either machine.  If this parameter is not given then COM1
  233.                 is used.  If the port specified does not exist then the
  234.                 program cannot continue and will abort.
  235.  
  236. /nnn            This will specify the baud rate divisor.  The "nnn" is any 
  237.                 decimal number from 0 to 199.  The default is "/2" which is 56k 
  238.                 baud.  Both computers must use the same baud rate, so if this 
  239.                 parameter is entered on one machine, the same value must also 
  240.                 be entered on the other.  Some selected values are: 
  241.  
  242.                         /1      115,200 baud 
  243.                         /2       57,600 baud   <-- default
  244.                         /3       38,400 baud
  245.                         /6       19,200 baud
  246.                         /12       9,600 buad
  247.                         /16       7,200 baud
  248.                         /24       4,800 baud
  249.                         /32       3,600 baud
  250.                         /48       2,400 baud
  251.                         /96       1,200 baud
  252.                         /192        600 baud
  253.  
  254.  
  255. SHARE:abc...    The slave can specify which drives the master may control and 
  256.                 in which order they are presented.  "SHARE:ca" would allow the 
  257.                 master to access drives C and A drives only, and in that order. 
  258.                 If the Master had drives A, B, and C installed locally, then 
  259.                 its logical drive D would be the slave's drive C because C was 
  260.                 the first drive in the slave's SHARE: list.  The master's drive 
  261.                 E would be the slave's drive A because A was the second drive 
  262.                 in the SHARE: list.  There can be no space between the colon 
  263.                 and the drive letters.  Up to 16 drive letters can be 
  264.                 specified.  The drive letters can be in any order and can be 
  265.                 any valid block device including ram drives.  The only 
  266.                 limitation is that the device must use 512 byte sectors.  If
  267.                 SHARE: is not specified then the default used is 
  268.                 "SHARE:abcdefghijklmnop".  This parameter is valid for the 
  269.                 slave only.
  270.  
  271.  
  272. @nn             The master needs to know how many drive units to allocate to 
  273.                 the slave.  If this parameter is unused then the master assumes 
  274.                 4 drive units reside on the slave.  In most cases this is just 
  275.                 fine,  but if the master has too many drives of its own, or if 
  276.                 the master must define some more drives after the slave, or if 
  277.                 the slave has more than 4 drives, then the "@nn" parameter can 
  278.                 be used to limit or extend the number of logical drives used up 
  279.                 by the slave.  "nn" can be any decimal number from 1 to 16.  
  280.                 The default is "@4".  This parameter is valid for the master 
  281.                 only.  
  282.  
  283.  
  284.  
  285.  
  286.         NOTE:   The command line parameters may be entered in any order and
  287.                 in either upper or lower case.
  288. ;page
  289.                                                                         PAGE 5
  290.  
  291.  
  292.                                      *** CABLE ***
  293.  
  294.  
  295.  
  296.  
  297. NULL modem cable,  only 5 lines are used:
  298.  
  299.  
  300.  
  301.  
  302.                        Computer 1                            Computer 2
  303.                        ----------                            ----------
  304.  
  305.                        13*                                    13*
  306.                              *25                                    *25
  307.                          *                                      *
  308.                              *                                      *
  309.                          *                                      *
  310.                              *                                      *
  311.                          *                                      *
  312.                              *                                      *
  313.                          *                                      *
  314.                              *                                      *
  315.                          *                                      *
  316.                              *-DTR------\  /----------------DTR-----*
  317.                   GROUND *----------->>  \/  <<-----------------* GROUND
  318.                              *           /\                         *
  319.                      DSR *--------------/  \----------------DSR-*
  320.                              *                                      *
  321.                          *                                      *
  322.                              *                                      *
  323.                          *                                      *
  324.                              *                                      *
  325.                 RCV DATA *-----------------\ /------------------* RCV DATA
  326.                              *              X                       *
  327.                 TMT DATA *-----------------/ \------------------* TMT DATA
  328.                              *14                                    *14
  329.                         1*                                     1*
  330.  
  331.  
  332.  
  333.  
  334.                   
  335.                     
  336.                     6' Ready made cable available for ...........$ 15.00
  337.                     Programs and source on 5 1/4 inch media .....$ 15.00
  338.                     Programs and source on 3 1/2 inch media ......+ 5.00
  339.                     Shipping in U.S. .............................  free
  340.  
  341.                     Total package ...............................$ 30.00
  342.  
  343. ;page
  344.                                                                  9/23/87
  345.                                                                  3/10/88
  346.                                                                  7/28/88
  347.  
  348.                                   APPENDIX
  349.  
  350.  
  351.         If you find this program to be of value please register your copy for 
  352. $15.   The WEAK Link is as good as or superior to similar products which would 
  353. cost you $70-$150.  Your money will directly help fund new products which may 
  354. be even more valuable to you than this one.  We specialize in high quality 
  355. software at ridiculously low prices.  Your $15 check can be sent to: 
  356.  
  357.                              Information Modes
  358.                              P.O. Drawer F.
  359.                              Denton, Texas  76202
  360.  
  361. You can also call me personally at 817-387-3339.  You'll never get an answering 
  362. machine (I HATE THEM) and I'm always glad to answer any questions 7 days a 
  363. week, day or night.  If you send me a check, a registered copy of the program, 
  364. including all source code, will be sent within 24 hours.  You'll find the 
  365. support you will get far exceeds the so-called support you get from the major 
  366. software companies.  Try calling them with any technical question.  Here you 
  367. can speak to the author direct.
  368.  
  369.  
  370.  
  371.  
  372.         The WEAK Link was actually a spinoff product generated while working
  373. on a far superior program called:
  374.                             _____________________
  375.                            [                     ]
  376.                            [   The $25 Network   ]
  377.                            [_____________________]
  378.  
  379. I had long wanted a network for my two computers but the cost of even the 
  380. cheapest setup was prohibitive.  I decided to write my own network program 
  381. using the RS232 cards I already had. Since networking software was relatively 
  382. complex, I thought it would be best to tackle a simpler project first.  The 
  383. WEAK Link was a "study" to make sure I understood DOS block device drivers.  It 
  384. took me about 2-3 weeks.  I then used some of the concepts I had learned to 
  385. develop The $25 Network.  It was far more complex because I wanted to be able 
  386. to use both computers at any time, regardless of the activity on the other.  
  387. This project took about 3 months.  But I now have a two or three computer 
  388. network on which I can share any device - including disks and printers - at any 
  389. time.  Its speed is equivalent to The WEAK Link.  I am also working on a larger 
  390. network which will support even more machines, possible 20-30.  It will support 
  391. computer to computer links via serial cards, parallel cards, or a cheap network 
  392. card of my own design.  I also intend to support modem links.
  393.  
  394.         I hope you will register your copy of The WEAK Link.  But if you like 
  395. the WEAK Link and are considering registering it, you may want to buy The $25 
  396. Network instead because it renders The WEAK Link obsolete.  Of course, if you 
  397. want source code then The WEAK Link will provide you with a good example of how 
  398. to write DOS device drivers.  I will not offer source to The $25 Network.  
  399. Neither will I offer it as a shareware program.  
  400.  
  401. ;page
  402.    __________________________________________________________________________
  403.   [                                                                          ]
  404.   [                         European customers                               ]
  405.   [                                                                          ]
  406.   [    As of 3/3/88, the registered version of The WEAK Link and a German    ]
  407.   [    language version of The $25 Network is available from:                ]
  408.   [                                                                          ]
  409.   [                      Kirschbaum Software GmbH                            ]
  410.   [                      Kronau 15                                           ]
  411.   [                      D-8091 Emmering                                     ]
  412.   [                      West Germany                                        ]
  413.   [                      Tel. (0 80 67) 12 20                                ]
  414.   [                      Fax. (0 80 67) 10 53                                ]
  415.   [                                                                          ]
  416.   [   Other versions may be available.                                       ]
  417.   [__________________________________________________________________________]
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424. Other software products available from Information Modes:
  425.  
  426.  
  427. 1)  The $25 Network ................................... $25
  428. 2)  DOS 1.1 Disassembled, fully commented ............. $20
  429. 3)  DOS 2.1 Disassembled, fully commented ............. $45
  430. 4)  DOS 3.2 Disassembled, fully commented ............. ??? not yet set
  431. 5)  Hercules Tools + CGA Emulator (+source)............ $15
  432. 6)  Technical Manual .................................. $5
  433. 7)  8741/2/8/9 Emulator (+source)...................... $15
  434. 8)  The WEAK Link, (this) serial version (+souce)...... $15
  435. 9)  The WEAK Link, parallel port version (+source)..... $15
  436.